package com.hwpt.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.oas.annotations.EnableOpenApi;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

/**
 * Knife4j 配置类（Swagger 增强版）
 */
@Configuration
@EnableOpenApi // 开启 OpenAPI 支持（Knife4j 基于 OpenAPI 3.0）
public class SwaggerConfig {

    /**
     * 配置 API 文档信息
     */
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.OAS_30)
                // 配置 API 基本信息
                .apiInfo(apiInfo())
                // 配置扫描的控制器包路径（根据你的项目结构调整）
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.hwpt.controller")) // 扫描所有控制器
                .paths(PathSelectors.any()) // 匹配所有路径
                .build();
    }

    /**
     * 定义 API 文档的基本信息（标题、描述、版本等）
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("汉王账号系统 API 文档") // 文档标题
                .description("包含用户注册、登录、验证码等认证相关接口") // 文档描述
                .version("1.0.0") // 接口版本
                .contact(new Contact(
                        "开发团队", // 联系人
                        "https://your-website.com", // 联系网址
                        "your-email@example.com" // 联系邮箱
                )) // 联系人信息
                .build();
    }
}
